# qpi-config

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

**qpi-config** is a tool for configuring **Quectel Pi H1** single-board computer. It supports the following functions:

1. Configure the operating mode and brightness of the on-board **LEDs**.

2. Configure the operating mode and speed of the fan interface.

3. Configure the operating mode of the **40-pin** interface.

4. Query the temperature of each system module.

5. Query the system's **CPU**, memory, and storage status.

6. Configure **Wi-Fi**.

# On-board LED configuration

Run the following command to configure the operating mode:

```shell
sudo qpi-config led mode <blue|green|red> <heartbeat|none>
```

Run the following command to configure the brightness:

```shell
sudo qpi-config led brightness <blue|green|red> <0-511>
```

```{image} images/image_Bwv4bVC3ToYAQKxy85FcioGjnWh.webp
:width: 910px
:height: 508px
```

# Fan configuration

Run the following command to configure the fan speed:

```shell
sudo qpi-config fan set speed <0-255>
```

```{image} images/image_QmfAbaqChoxRkkxgGwzcZwJ8nje.webp
:width: 910px
:height: 509px
```

# 40-Pin interface operating mode configuration

First modify the configuration file **/etc/qpi-config/qpi-config.ini**, and then run the following command to apply the configuration:

```shell
sudo qpi-config 40pin set
```

- Note: The changes will take effect after the board is rebooted.

```{image} images/image_QpXdbLVvUo9MKUx5teBcgOCInng.webp
:width: 908px
:height: 507px
```

# Query system module temperatures

Run the following command to query module temperatures:

```shell
sudo qpi-config dump temperature
```

```{image} images/image_F8ydbHOVyoR9oAxeCV8cwN0XnHd.webp
:width: 901px
:height: 513px
```

# Query system CPU, memory, and storage status

Run the following command to query system CPU, memory, and storage status:

```shell
sudo qpi-config dump systemusage
```

```{image} images/image_Ecofbnz8VoHqghxEPdqcZzGPnfc.webp
:width: 898px
:height: 334px
```

# Configure Wi-Fi

Run the following command to scan for available **Wi-Fi** networks:

```shell
sudo qpi-config wifi scan
```

```{image} images/image_D5qmbJdjEobTKexDEzhclrtSnah.webp
:width: 897px
:height: 560px
```

Run the following command to view existing Wi-Fi connections:

```shell
sudo qpi-config wifi show
```

Run the following command to check the **Wi-Fi** connection status:

```shell
sudo qpi-config wifi dump <connection uuid>
```

Run the following command to add **Wi-Fi** connection:

```shell
sudo qpi-config wifi connect <ssid> <password>
```

- After successful connection, the corresponding wireless network status will be displayed as **Connected**, and the **Wi-Fi** connection icon will appear in the upper right corner.

```{image} images/image_XvZbbWDJNo4ODLxq4f6cIN58nMe.webp
:width: 1407px
:height: 785px
```

Run the following command to delete **Wi-Fi** connection:

```shell
sudo qpi-config wifi remove <connection uuid>
```